package com.bodu.core.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.bind.annotation.RestController;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.ArrayList;

/**
 * @author gaoya
 * @Description swagger 配置
 * @date 2022 - 04 - 16 11:12:16
 */
@Configuration
@EnableSwagger2
public class SwaggerConfig {

    /**
     * swagger 的核心配置
     *
     * @return
     */
    @Bean
    public Docket docket() {
        // DocumentationType.SWAGGER_2 指定文档类型为Swagger2
        return new Docket(DocumentationType.SWAGGER_2)
                // 指定文档的具体信息
                .apiInfo(info()).select()
                // 指定需要扫描的包信息
                .apis(RequestHandlerSelectors.basePackage("com.bodu"))
                // 需要扫描的类上注解
                .apis(RequestHandlerSelectors.withClassAnnotation(RestController.class))
                // 需要扫描方法上的主键
//                .apis(RequestHandlerSelectors.withMethodAnnotation(GetMapping.class))
                // 指定扫描所以的controller
                /***
                 * paths 过滤路径的
                 * PathSelectors.any() 扫描全部
                 * PathSelectors.no()  不扫描
                 */.paths(PathSelectors.any()).build()
                // 配置是否启动，true swagger 启动 false swagger 不启动
                .enable(true);
    }

    private ApiInfo info() {
        // 作者描述信息
        Contact contact = new Contact("御研堂", "bodu.xyz", "931590302@qq.com");
        // 文档详细信息
        return new ApiInfo("扬州小程序后台管理模块", "预约、商城、到店等模块开发", "v1.0",
                // 网站地址
                "www.bodu.xyz",
                // 作者描述信息
                contact,
                // 监听信息
                "Apache 2.0",
                // 监听协议地址
                "http://www.apache.org/licenses/LICENSE-2.0", new ArrayList());
    }
}
